home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3n / t_close.z / t_close
Encoding:
Text File  |  1998-10-20  |  3.9 KB  |  67 lines
  1.  
  2.  
  3.  
  4. tttt____cccclllloooosssseeee((((3333NNNN))))                                                        tttt____cccclllloooosssseeee((((3333NNNN))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _tttt______cccc_llll_oooo_ssss_eeee - close a transport endpoint
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_ffff_dddd_eeee_ffff ______XXXX_OOOO_PPPP_EEEE_NNNN______SSSS_OOOO_UUUU_RRRR_CCCC_EEEE
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_xxxx_tttt_iiii_...._hhhh_>>>>
  14.      _####_eeee_llll_ssss_eeee
  15.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_tttt_iiii_uuuu_ssss_eeee_rrrr_...._hhhh_>>>>
  16.      _####_eeee_nnnn_dddd_iiii_ffff
  17.  
  18.      _iiii_nnnn_tttt _tttt______cccc_llll_oooo_ssss_eeee_((((_ffff_dddd_))))
  19.      _iiii_nnnn_tttt _ffff_dddd_;;;;
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      The _tttt______cccc_llll_oooo_ssss_eeee function informs the transport provider that the user is
  23.      finished with the transport endpoint specified by _ffff_dddd, and frees any local
  24.      library resources associated with the endpoint.  In addition, _tttt______cccc_llll_oooo_ssss_eeee
  25.      closes the file associated with the transport endpoint.
  26.  
  27.      _tttt______cccc_llll_oooo_ssss_eeee should be called from the _TTTT______UUUU_NNNN_BBBB_NNNN_DDDD state [see _tttt______gggg_eeee_tttt_ssss_tttt_aaaa_tttt_eeee(3N)].
  28.      However, this function does not check state information, so it may be
  29.      called from any state to close a transport endpoint.  If this occurs, the
  30.      local library resources associated with the endpoint will be freed
  31.      automatically.  In addition, _cccc_llll_oooo_ssss_eeee(2) will be issued for that file
  32.      descriptor; the close will be abortive if no other process has that file
  33.      open, and will break any transport connection that may be associated with
  34.      that endpoint.
  35.  
  36.      This function resides within both the X/Open compliant _llll_iiii_bbbb_xxxx_nnnn_eeee_tttt and the
  37.      SVR4 compliant _llll_iiii_bbbb_nnnn_ssss_llll Network Services libraries.  Network Services
  38.      applications which require X/Open compliance must link-load with _----_llll_xxxx_nnnn_eeee_tttt.
  39.      Network Services applications which require SVR4 compliance must link-
  40.      load with _----_llll_nnnn_ssss_llll.
  41.  
  42.      On failure, _tttt______eeee_rrrr_rrrr_nnnn_oooo may be set to the following:
  43.  
  44.      _[[[[_TTTT_BBBB_AAAA_DDDD_FFFF_]]]]      The specified file descriptor does not refer to a transport
  45.                   endpoint.
  46.  
  47. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  48.      _tttt______gggg_eeee_tttt_ssss_tttt_aaaa_tttt_eeee(3N), _tttt______oooo_pppp_eeee_nnnn(3N), _tttt______uuuu_nnnn_bbbb_iiii_nnnn_dddd(3N)
  49.  
  50. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  51.      _tttt______cccc_llll_oooo_ssss_eeee returns 0 on success and -1 on failure and _tttt______eeee_rrrr_rrrr_nnnn_oooo is set to
  52.      indicate the error.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.